---
title: Instagram
sidebarTitle: Instagram
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/instagram/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/instagram/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ❓ |  |
| Paid test account | ❓ |  |
| Partnership | ❓ | |
| App review | ❓ |  |
| Security audit | ❓ | |


## Setup guide

_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/instagram.mdx)</Note>


## Useful links

-   Apps for the Instagram API can be [registered here](https://developers.facebook.com/apps)
-   [Instagram Basic Display API docs](https://developers.facebook.com/docs/instagram-basic-display-api)
-   [Instagram Basic Display API OAuth scopes](https://developers.facebook.com/docs/instagram-basic-display-api/overview/permissions) -> These scopes did not work for me. What worked was `user_profile` and `user_media`.
-   [Instagram Graph API docs](https://developers.facebook.com/docs/instagram-api) (see below for how to add OAuth)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/instagram.mdx)</Note>

## API gotchas

-   For the Basic Display API, the scope `user_profile` is mandatory. The only other available scope seems to be `user_media`.
-   For access to the [Instagram Graph API](https://developers.facebook.com/docs/instagram-api), follow these steps:
    1. The Instagram Graph API uses [Facebook OAuth](/integrations/all/facebook) to authenticate the accounts. Add a provider config for it to Nango with the scopes [specified here](https://developers.facebook.com/docs/instagram-api/getting-started#2--implement-facebook-login).
    2. Once the login flow completes, you can [query the facebook API for the Instagram account details](https://developers.facebook.com/docs/instagram-api/getting-started#4--get-the-user-s-pages) (follow steps 4-6).

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/instagram.mdx)</Note>
